The HA configuration file contains four components. To ensure the smooth running of your HATS HA, please use the following procedure to set up each component in the HA configuration file.

1. Previewing the whole configuration file:
   A. At system prompt, type:cd /usr/HA/ha_file. Press ENTER.
   B. At system prompt, type:vi config.blank. Press ENTER.
   
   
   • This will bring up the blank configuration file to give you an overview of what
     you need to configure.
   
   

   # HA configuration file # ################################# #................ License Definition................. # ################################# # LICENSE= LICENSE= SERI AL= SERIAL= DATE= DATE= # # ################################# #............. Node Definition........................# ################################# # HOST_NODE= # ORGINAL_IP= ORGINAL_IP= ORGINAL_ETHER= ORGINAL_ETHER= # # ################################# #..................Job Definition...................... # ################################# # JOB_NAME= # JOB= # ACT_NODE= ACT_LAN= ACT_IP= # SHARE_DI SK= MOUNT_POINTER= # STANDBY_NODE= STANDBY_LAN= STA NDBY_DISK= # # # # ################################# #........ .........Misc. Definition................... # ################################# # HEART_BEAT= HEART_BEAT= # ALIVE_CHECK_TIME= DEVICE_CHECK_TIME= SYNC_DISK_TIME= # ##end

   
   Note:

   There are two files ("config.sample" and "config.syntax") in HATS HA that provide usefule examples and syntax information to help you set up your own configuration.

   It is helpful to have these two files open in two other different windows for your reference while setting up your own configuration. Use the following procedure:
   

   A. Click anywhere on the screen background to bring up the Workspace menu.
   B. Click on Programs on the Workspace menu.
   C. Click on Command Tool on the Programs menu.
   D. At system prompt, type: vi /usr/HA/ha_file/config.sample. Press ENTER.
   
   • This will bring up the following screen:
   
   

   # HA configuration file # ################################# #...........LicenseDefinition..........................# ################################# # LICENSE=russell:6BD84BC01095F57A LICENSE=peter:EAFEF623F7F970AF SERIAL=russell:1234567890123456 SERIAL=peter:1234567890123456 DATE=russell:03201996 DATE=peter:03201996 # # ################################# #.........Node Definition............................. # ################################# # HOST_NODE=russell,peter # ORGINAL_IP=russell:le0:russell,le1:russell-1 ORGINAL_IP=peter:le0:peter,le1:peter1 ORGINAL_ETHER=russell:8:0:20:1a:ab:8e ORGINAL_ETHER=peter:8:0:20:1b:cd:99 # # ################################# #...............Job Definition.......................... # ################################# # JOB_NAME=nfs1,nfs2 # JOB=nfs1 # ACT_NODE=russell ACT_LAN=le1 ACT_IP=act1 # SHARE_DISK=/dev/dsk/c1t3d0s0 MOUNT_POINTER=/share_nfs1 # STANDBY_NODE=peter STANDBY_LAN=le1 STANDBY_DISK=/dev/dsk/c1t3d0s0 # SUPPORT=NFS # JOB=nfs2 # ACT_NODE=peter ACT_LAN=le0 ACT_IP=act0 # SHARE_DISK=/dev/dsk/c1t3d0s1 MOUNT_POINTER=/share_nfs2 # STANDBY_NODE=russell STANDBY_LAN=le0 STANDBY_DISK=/dev/dsk/c1t3d0s1 # SUPPORT=NFS # ################################# #................Misc. Definition...................... # ################################# # HEART_BEAT=russell:le0 HEART_BEAT=peter:le0 # ALIVE_CHECK_TIME=8 DEVICE_CHECK_TIME=10 SYNC_DISK_TIME=20 # ##end

   
   
   E. Follow the above procedure to open another window for "config.syntax".
   At system prompt, type: vi /usr/HA/ha_file/config.syntax. Press ENTER.
   
   
   • This will bring up the following screen:
   
   

   # HA configuration syntax file # #################################### #....................License Definition..................... # #################################### # LICENSE=<hostname1>:< licensenumber1> [...] SERIAL=<hostname1>:<serial number1> [...] DATE=<hostname1>:<mmddyyyy> [...] # # #################################### #...............Node Definition............................ # #################################### # HOST_NODE=<hostname1> [,<hostname2>,...,<hostname5>] # ORGINAL_IP=<hostname1>:<interface1>:<ip1>[,<interface2> :<ip2>,...,<interface9>:<ip9>] [...] ORGINAL_ETHER=<hostname1>:<ethernethardware address1> [...] # options start # options start ORGINAL_NETMASK=<hostname1>:<interface1>:<netmask1> [,<interface2>:<netmask2>,...,<interface9>:<netmask9>] [...] #options end # options end # # #################################### #..................... Job Definition.........................# #################################### # JOB_NAME=<jobname1>[,<jobname2>,...,<jobname5>] # JOB=<jobname1> # ACT_NODE=<hostname?> ACT_LAN=<interface?> ACT_IP=<ipact> # SHARE_DISK=</dev/dsk/cWtXdYsZ> [,</dev/dsk/cWtXdYsZ>] MOUNT_POINTER=<absolutepath1>[,<absolutepath2>] # STANDBY_NODE=<hostname?>[,<hostname?>,...,<hostname?>] STANDBY_LAN=<interface?>[,<interface?>,...,<interface?>] STANDBY_DISK=</dev/dsk/cWtXdYsZ>{[,</dev/dsk/cWtXdYsZ>] :</dev/dsk/cWtXdYsZ>[,</dev/dsk/cWtXdYsZ>]:...:</dev/dsk/cWtXdYsZ> [,</dev/dsk/cWtXdYsZ>]} # #options start # options start ACT_ETHER=<ethernet hardware address act> ACT_NETMASK=<netmaskact> SUPPORT=<NFS|[space],NFS|[space]> MOUNT_OPTIONS=<option1>[,<option2>] SHARE_OPTIONS=<option1>[,<option2>] SWITCH_BACK=<no|yes> LAN_ALLCHECK=<no|yes> #options end # options end # JOB=<jobname2> # ... ... # # JOB=<jobname9> # ... ... # # # ##################################### #......................Misc. Definition....................... # ##################################### # HEART_BEAT=hostname1:[<terminaldevice>|<interface?>] [...] ASYNC_RATE=<9600|19200> # ALIVE_CHECK_TIME=<seconds> DEVICE_CHECK_TIME=<seconds> SYNC_DISK_TIME=<seconds> # # #options start # options start CHECK_LAN=<yes|no> CHECK_DISK=<yes|no> DETECT_ONLINE=<no|yes> # DISPLAY_TRACE=<no|yes> LAN_ERROR_BEEP=<no|yes> LAN_ERROR_ROUTE=<no|yes> LAN_ERROR_COUNT=4 # START_SYNC_TIME=20 DETECT_WAIT_TIME=40 STANDBY_WAIT_TIME=30 # SHARE_KEY=8800 SEND_BEAT_PORT=12100 SEND_INTER_PORT=12200 SEND_DETECT_PORT=12300 SEND_BROADCAST_PORT=12400 # IN_JOB_TIME=240 SEND_INFO_TIME=60 LOOP_BACK_COUNT=5 # STATUS_ROW=30 STATUS_COL=32 STATUS_XAXIS=53 STATUS_YAXIS=25 HISTORY_ROW=9 HISTORY_COL=42 HISTORY_XAXIS=53 HISTORY_YAXIS=513 NEXT_OFFSET=334 STATUS_FONT=10x12 HISTORY_FONT=8x13 STATUS_COLOR=hostname1:aquamarine [...] HISTORY_COLOR=hostname2:Lightcyan [...] #options end # options end ##end

   
   
   2. Configuring License Definition
   
   

   Important!!! Before you can configure the License Definition, you must contact H.A. Technical Solutions, LLC to obtain valid license and serial numbers.

   
   Note:

   Before setting up the License Definition section, you must have your hostname ready.

   To obtain your hostname, at system prompt, type: /usr/ucb/hostname. Press ENTER.Your hostname will appear in a separate line.
   

   A. Go to the License Definition section in "config.blank" window.
   

   ################################# #................License Definition.................. # ################################# # LICENSE= LICENSE= SERIAL= SERIAL= DATE= DATE= #

   
   B. Fill in the license number.
   a. At the first license = sign, type in your host name followed by":" and
   the 16-digit license number.
   b. Do the same for the other one.
   
   Notes:
   
   1. The default number of machines is 2. If you have more than two
      machines running HATS HA, you must manually enter the words
      "LICENSE=" for each machine and then type in their license numbers.
   2. At present the maximum number of machines allowed to run HA
      at the same time is 5.
      
   
   C. Fill in the serial number.
   a. At the first serial = sign, type in your host name followed by":" and
   the 16-digit serial number.
   b. Do the same for the other one.
   
   Notes:
   
   1. The default number of machines is 2. If you have more than two
      machines running HATS HA, you must manually enter the words
      "SERIAL=" for each machine and then type in their serial numbers.
   
   D. Fill in the dates.
   1. At the first date = sign, type in your host name followed by ":"and the
      8-digit date. For example: DATE=leroy:03201996
   2. Do the same for the other one.
   
   Note:
   
   1. The default number of machines is 2. If you have more than two
      machines running HATS HA, you must manually enter the
      words "DATE=" for each machine and then type in their dates.
      
   3. Configuring Node Definition
   

   Important!!! Before configuring the Node Definition, make sure all the workstations running HA are connected to a shared disk or disk array!

   
   A. Go to the Node Definition section in "config.blank" window.
   

   ################################# #.....................Node Definition................ # ################################# # HOST_NODE= # ORGINAL_IP= ORGINAL_IP= ORGINAL_ETHER= ORGINAL_ETHER= #

   
   B. At "HOST_NODE=", enter the hostnames for all the machines running HA.
   
   Notes:
   
   
   1. Copy each hostname exactly as it appears on your machine.
   2. Use "," to separate hostnames.
   
   C. Define the original IP addresses for each machine.
   
   1. At the first "ORGINAL_IP=," enter the first machine's hostname and all its ethernets with their nicknames.
      Notes:
      
      1. Find out how many ethernet interfaces the machine has and enter all of them.
         (If you don't know how many ethernet interfaces a machine has, you
         may find out the information by typing at system prompt: /usr/bin/dmesg.)
      2. Enter only the nicknames of the original IP addresses as saved in /etc/hosts.
      3. Do NOT enter the numeric IP addresses.
      4. Example: ORGINAL_IP=leroy:le0:apple,le2:orange
         In this example, the two ethernet interfaces found in /usr/bin/dmesg
         are le0 and le2. Their IP addresses are respectively: 192.22.23.1
         and 192.22.24.1, and their nicknames are apple and orange as saved
         in /etc/hosts.
      
      
   2. Repeat the above procedure for each machine.
      
   D. Define the ethernet hardware address.
   
   1. At the first "ORGINAL_ETHER=," enter your machine's hostname
      and its ethernet hardware address.
      
      Note:
      
      You can find out your ethernet hardware address by typing at system prompt:
      /usr/dmesg/ | grep Ethernet. Press ENTER.
      
      
   2. Example: ORGINAL_ETHER=leroy:8:0:20:1a:b1:19
      
   3. Repeat the above procedure for each machine.
   
   4. Configuring Job Definition
   
   Notes:
   
   1. Before proceeding to configure the Job Definition, you should understand what is
      a job. A job in this context is basically a service that the server is providing to its
      clients. So, if your server provides 10 different services such as sybase, internet,
      nfs, etc. all at the same time to your clients, your server is then handling 10 jobs.
      
   2. You can give each job any name you like, e.g., cowboy for your internet service
      as long as it is less than 20 characters. Later you will have to write an executible
      script for each job for the machine to start or stop the service.
   3. Another important point: 1 ethernet interface can only handle 1 job.
   4. At present HATS HA can only handle 10 jobs.
   
   A. Go to the Job Definition section in "config.blank" window.
   
   

   ################################# #.................Job Definition....................... # ################################# # JOB_NAME= # JOB= # ACT_NODE= ACT_LAN= ACT_IP= # SHARE_DISK= MOUNT_POINTER= # STANDBY_NODE= STANDBY_LAN= STANDBY_DISK= #

   
   B. At "JOB_NAME=," enter the names of all your jobs separating each by a comma.
   For example: JOB_NAME=cowboy,swimminggirl,deadbeat
   
   C. For each job, you need to configure the following information. The following is an
   example to configure the information for the job called "cowboy."
   
   1. At "JOB=," enter cowboy. Result: JOB=cowboy
   2. At "ACT_NODE=," enter the hostname for the machine that was
      originally assigned to handle a specific job.
      
      Example: ACT_NODE=leroy
      
      In this example, "leroy" is the hostname for the machine that was
      originally assigned to perform the job called "cowboy."
      
   3. At "ACT_LAN=," enter the name for the ethernet interface that
      was originally assigned to handle a specific job.
      Example: ACT_LAN=le1
      In this example, "le1" is the ethernet interface that was originally assigned
      to perform the job called "cowboy."
      
      Note: It is a good idea not to "le0" for ACT_LAN because other
      software may need to use the original IP for "le0."
      
      
   4. At "ACT_IP=," enter the IP nickname that the client uses to connect to
      the server to handle a specific job.
      Example: ACT_IP=mississippi
      
      In this example, the active IP called "mississippi" allows the client to connect
      to the server to perform the job called "cowboy."
      
   5. At "SHARE_DISK=," enter the information about the shared disk or disk
      array where the data for the job called "cowboy" is stored.
      Example: SHARE_DISK=/dev/dsk/c1t0d0s1
      
      Notes:
      
      1. The information about the shared disk or disk array must be preceded
         by /dev/dsk/.
      2. In this example, "c1t0d0" refers to the shared disk while "1" at the end
         refers to the partition number in the shared disk where the data for the
         job called "cowboy" is stored.
      3. The partition number for the shared disk must be preceded by the letter "s".
      
      
   6. At "MOUNT_POINTER=," enter a name between two absolute paths
      for the storage location of the data for the job called "cowboy."
      Example: MOUNT_POINTER=/warehouse/
      
      Notes:
      
      1. The nickname "warehouse" refers to the same partition on the shared
         disk you just entered in e. A nickname allows the client to find the
         storage location for the data for the job "cowboy."
      2. With what you have entered so far, your client can follow "mississippi"
         to find "warehouse" to extract the information to perform the job called
         "cowboy."
         
   7. At "STANDBY_NODE=," enter the hostname for the machine that will
      serve as the standby machine.
      Example: STANDBY_NODE=susan
      
      In this example, the machine named "susan" has been assigned to standby
      for the job called "cowboy."
      
   8. At "STANDBY_LAN=," enter the name for the ethernet interface that
      will serve as the standby ethernet interface.
      Example: STANDBY_LAN=le1
      
      Notes:
      
      1. The ethernet interface must be one of the ethernet interfaces originally
         defined in "Node Definition."
      2. Both the ACTIVE LAN and the STANDBY LAN must be connected
         to the same hub.
      
      
   9. At "STANDBY_DISK=," enter the information about the partition number
      in the shared disk as viewed from the standby machine. Remember: this is
      the partition on the shared disk where the "cowboy" job data is stored.
      Example: STANDBY_DISK=/dev/dsk/c1t0d0s1
      
      Note:
      
      Usually this should be the same information as you entered for "SHARE_
      DISK" in e. However, your machine sometimes may be configured differently.
      That may change how your machine views the shared disk.
      
      5. Configuring Misc. Definition
      
      A. Go to the Misc. Definition section in "config.blank" window.
      
      

      ################################# #.............Misc. Definition.........................# ################################# # HEART_BEAT= HEART_BEAT= # ALIVE_CHECK_TIME= DEVICE_CHECK_TIME= SYNC_DISK_TIME= #

      
      B. At the first "HEART_BEAT=," enter hostname and heartbeat device name.
      Example: HEART_BEAT=leroy:le0
      
      In this example, the "leroy" machine uses an ethernet as its heartbeat device.
      
      If your machine uses a serial port as its heartbeat device, enter it as follows:
      Example: HEART_BEAT=susan:/dev/term/a
      
      Notes:
      
      1. If one machine uses a serial port as its heartbeat device, the other machine
         must also use a serial port as its heartbeat device.
      2. If you have three or more machines running HA, you must ethernet as their
         heartbeat device.
      
      C. At the second "HEART_BEAT=," follow the above procedure to do the same.
      
      D. At "ALIVE_CHECK_TIME=," enter the length of time that you want the
      standby machine to wait before it takes over the job from the crashed machine.
      Example: ALIVE_CHECK_TIME=8
      
      In this example, the standby machine is set up to wait 8 seconds before it
      finally takes over the job from the crashed machine. You may decrease or
      increase the length of time to fit your own needs.
      
      E. At "DEVICE_CHECK_TIME=," enter the length of time that you want the
      standby machine to wait before it takes over the job from the active machine
      when one of its hardware components breaks.
      Example: DEVICE_CHECK_TIME=10
      
      In this example, the standby machine is set up to wait 10 seconds before it
      finally takes over the job from the active machine if HA detects a malfuntioning
      component in the active machine or a malfunctioning ethernet connected to it.
      
      F. At "SYNC_DISK_TIME=," enter the length of time that you want the active
      machine to wait before it syncs all the data onto the shared disk.
      Example: SYNC_DISK_TIME=20
      
      In this example, the active machine is set up to sync all the active data onto the
      shared disk every 20 seconds. Shortening the sync time makes it less likely to
      lose large amounts of data.
      
      Congratulations! You have now finished all the basic configurations for HA.
      
      5. Saving HATS HA Configuration File
      
      To use the completed configuration file to run HA, use the following commands to save it:
      
      A. Save "config.blank" and get to system prompt.
      B. At system prompt, type: cp config.blank /usr/HA/ha_file/config.ha